home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / archvrs / mac / uudecode.hqx / uuencode.1 < prev    next >
Encoding:
Text File  |  1988-03-16  |  2.6 KB  |  91 lines
  1. .TH UUENCODE 1 "1 Sep 1987"
  2. .UC 4
  3. .SH NAME
  4. uuencode,uudecode \- encode/decode a binary file for transmission via
  5. (plain text) mail
  6. .SH SYNOPSIS
  7. .B uuencode
  8. [source] remotedest |
  9. .B mail
  10. sys1!sys2!..!decode
  11. .br
  12. .B uuencode
  13. >outfile.uue source remotedest
  14. .br
  15. .B uuencode
  16. >outfile.uue <source remotedest
  17. .br
  18. .B uudecode
  19. [file]
  20. .SH DESCRIPTION
  21. .I Uuencode
  22. and
  23. .I uudecode
  24. are used to send a binary file via uucp (or other) mail.  This combination can
  25. be used over indirect mail links even when
  26. .IR uusend (1C)
  27. or other direct binary transmission methods are not available.
  28. .PP
  29. .I Uuencode
  30. takes the named source file (default standard input) and produces an encoded
  31. version on the standard output.  The encoding uses only printing ASCII
  32. characters, and includes the mode of the file and the
  33. .I remotedest
  34. for recreation on the remote system.
  35. .PP
  36. .I Uudecode
  37. reads an encoded file, strips off any leading lines added by mailers,
  38. and recreates the original file with the specified mode and name.  If
  39. there are other uuencoded files in the same input, they will be decoded
  40. as well.
  41. .PP
  42. The intent is that all mail to the user ``decode'' should be filtered
  43. through the uudecode program.  This way the file is created automatically
  44. without human intervention.  This is possible on the uucp network by either
  45. using
  46. .I sendmail
  47. or by making
  48. .I rmail
  49. be a link to
  50. .I Mail
  51. instead of
  52. .I mail.
  53. In each case, an alias must be created in a master file to get
  54. the automatic invocation of uudecode.
  55. .PP
  56. If these facilities are not available, the file can be uudecoded manually.
  57. .PP
  58. The encode file has an ordinary text form and can be edited by any text editor
  59. to change the mode or remote name.
  60. .PP
  61. This version of uuencode automatically adds checksums to each line, and
  62. an overall file size to the end.  Old versions of uudecode will ignore this
  63. extra information, new versions will check it and complain if it is in
  64. error.
  65. .PP
  66. Care has been taken with these versions to compensate for most of the nasty
  67. things editors and networks can do to files.  In particular, lines that
  68. have had trailing spaces truncated are handled, as are files that have
  69. passed through
  70. .I BITNET
  71. hosts.
  72. .SH SEE\ ALSO
  73. uuencode(5), uusend(1C), uucp(1C), uux(1C), mail(1)
  74. .SH AUTHOR
  75. Mark Horton
  76. .br
  77. Checksums and Amiga port by Alan J. Rosenthal
  78. .br
  79. File compatability added back in by Fred Fish
  80. .br
  81. File size check and various refinements by Bryce Nesbitt
  82. .SH BUGS
  83. The file is expanded by 35% (3 bytes become 4, plus control information)
  84. causing it to take longer to transmit.
  85. .PP
  86. The user on the remote system who is invoking
  87. .I uudecode
  88. (often
  89. .I uucp)
  90. must have write permission on the specified file
  91.